﻿//===============================================================================
// Microsoft patterns & practices Enterprise Library Contribution
// Query Application Block
//===============================================================================

using Microsoft.Practices.EnterpriseLibrary.Common.Configuration;
using Microsoft.Practices.EnterpriseLibrary.Common.Configuration.ObjectBuilder;
using Microsoft.Practices.ObjectBuilder2;
using EntLibContrib.Query.Parameters;

namespace EntLibContrib.Query.Configuration
{
	/// <summary>
	/// This type supports the Enterprise Library infrastructure and is not intended to be used directly from your code.
	/// Represents the process to build an <see cref="XmlParameter"/> described by a <see cref="XmlParameterData"/> configuration object.
	/// </summary>
	/// <remarks>This type is linked to the <see cref="ParameterData"/> type and it is used by the <see cref="ParameterCustomFactory"/>
	/// to build the specific <see cref="IParameter"/> object represented by the configuration object.
	/// </remarks>
	public class XmlParameterAssembler : IAssembler<IParameter, ParameterData>
	{
		#region Public Methods
		/// <summary>
		/// This method supports the Enterprise Library infrastructure and is not intended to be used directly from your code.
		/// Builds a <see cref="XmlParameter"/> based on an instance of <see cref="XmlParameterData"/>.
		/// </summary>
		/// <param name="context">The <see cref="IBuilderContext"/> that represents the current building process.</param>
		/// <param name="objectConfiguration">The configuration object that describes the object to build. Must be an instance of <see cref="XmlParameterData"/>.</param>
		/// <param name="configurationSource">The source for configuration objects.</param>
		/// <param name="reflectionCache">The cache to use retrieving reflection information.</param>
		/// <returns>
		/// A fully initialized instance of <see cref="XmlParameter"/>.
		/// </returns>
		/// <seealso cref="ParameterCustomFactory"/>
		public IParameter Assemble(IBuilderContext context,
															ParameterData objectConfiguration,
															IConfigurationSource configurationSource,
															ConfigurationReflectionCache reflectionCache)
		{
			// cast the configuration data to the specifc data type
			XmlParameterData castObjectConfiguration = (XmlParameterData)objectConfiguration;
			// create the parameter
			IParameter createdObject = new XmlParameter(castObjectConfiguration.Name, castObjectConfiguration.Namespace);
			// return the fully built and populated parameter object
			return createdObject;
		}
		#endregion
	}
}
